home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / bbsutil / bbscomp2.zip / README < prev   
Text File  |  1989-09-03  |  5KB  |  105 lines
  1. LEGALITIES
  2.  
  3.     This product is not FREE, it is being distributed as Shareware.
  4.     This means you are granted a limited license to evaluate this
  5.     product.  If, after a 30 day trial period, you are still using
  6.     this program, you are required to register it.  Registered users
  7.     will be advised of upgrades and changes in documentation.
  8.  
  9.     While not INTENSELY complex, this program does constitute several
  10.     hours of developement on my part.  I certainly don't think I'll
  11.     get rich via distributing this program, but I would appreciate a
  12.     small registration fee if you find this program of value.
  13.     Registration fees and suggestions for enhancements are gratefully
  14.     accepted.  I don't think that a $5 fee is unreasonable, do you?  I
  15.     can be reached via E-mail on Exec-PC, Milwaukee, which I might
  16.     add, in my personal "un-biased" opinion, is THE best BBS in the
  17.     country!  (414) 964-5160.  Thanks!
  18.  
  19.     I claim no responsibilities for any damage incurred as a result of
  20.     using this program.  I reserve all rights to this program.
  21.  
  22.     (c) 1989 Gary L. Vandenberg
  23.              977 S. 56th St.
  24.              Milwaukee, WI 53214
  25.  
  26. RELEASE 2!
  27.  
  28.     Yes, folks, I made it!  The response to Version 1.0 was so
  29.     overwhelming that Release 2 is now available.  It now prompts you
  30.     for sorting prior to performing the compare that gives the Up and
  31.     Down load opportunities.  This should eliminate the step of
  32.     externally sorting your files prior to running the program.
  33.     I am using a "shell" sort algorythm to execute this.  Any 
  34.     performance tips for improving the sort time are greatly 
  35.     appreciated.  Enjoy!
  36.  
  37.  
  38. OVERVIEW
  39.  
  40.     This program is intended to assist the more-avid BBS'er.  It reads
  41.     in the your file list and the BBS's file list, and then produces
  42.     three output files.  The first file, UL.DAT, shows files that you
  43.     have and the BBS doesn't, showing your opportunities for uploading.
  44.     The second file, DL.DAT, shows files that the BBS has that you
  45.     don't, showing your download opportunities.  The third file,
  46.     COMMON.DAT, is intended as somewhat of an audit trail and shows the
  47.     files that you have in common with the BBS.
  48.  
  49.     While I don't run a BBS, I can certainly sympathize both with
  50.     SYSOP's trying to get users to upload, and also with users that
  51.     just want to "get those new files and try 'em out".  This program
  52.     should help users more easily comply with upload/download ratios,
  53.     etc., by showing the exact files that are suitable in either
  54.     direction.
  55.  
  56.  
  57. OPERATION
  58.  
  59.     This program was written in QuickBasic 4.5 (Nice Language!).  Many
  60.     BBS's seem to have standardized on the file directory display
  61.     format show below:
  62.  
  63.  
  64. JACKSON1.GIF    49152  02-08-89  Le Toya Jackson VGA Gif #2 in Series of 5
  65. JACKSON3.GIF    19456  02-08-89  Le Toya Jackson VGA Gif. #2 in series of 5
  66. JACKSON4.GIF    26624  02-08-89  Le Toya Jackson VGA Gif #4 in series of 5
  67.  
  68.     Given this format, it seemed simple enough to compare this list
  69.     type to my own computer's directory listing.
  70.  
  71.     STEP 1
  72.     First, you need to create an input listing of your files that you
  73.     want to compare to the BBSs'.  This can be obtained by by using
  74.     the command:
  75.  
  76.         DIR >FILENAME
  77.  
  78.     Or if you have a disk(ette) cataloging program that stores the
  79.     filename in ASCII, in positions 1 thru 12 or can export such a
  80.     report, that will do fine also.
  81.  
  82.     STEP 2
  83.     The second step in using this program, is to capture or download a
  84.     BBS file listing that you are interested in.  It again assumes the
  85.     above format, that is, at least the file name is expected to start
  86.     in column 1 and be no longer than 12 characters.
  87.  
  88.     STEP 3
  89.     Simple enough, start the enclosed program called BBSCOMP2.  You
  90.     will be prompted for YOUR directory file name and the BBS
  91.     directory file name.  You will then have the option of sorting the
  92.     input files first.  After the sort is complete, or you have
  93.     answered "no", the compare will start executing.  The output of
  94.     the program will be stored in the current sub-directory as UL.DAT, 
  95.     DL.DAT, and COMMON.DAT.
  96.  
  97.  
  98. NOTES
  99.  
  100.     File extensions are dropped during the compare since a program may
  101.     exist on your system in an excutable form (.EXE) and is most
  102.     likely in a compressed form on the BBS (.ZIP).  Any records that
  103.     start with a space or period are dropped, this helps filter your
  104.     listing if you attain it via the DIR >FILENAME sequence.
  105.